home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / source / snip9503 / snippets.rat < prev    next >
Text File  |  1995-03-14  |  3KB  |  53 lines
  1.                         SNIPPETS Rationale
  2.                         ------------------
  3.  
  4.  
  5. Where do SNIPPETS come from?
  6.  
  7. I'm constantly on the lookout for new SNIPPETS material. The goal of SNIPPETS
  8. has been to collect useful pieces of code that would be free for reuse. This
  9. limits consideration to code that is either explicitly in the public domain
  10. or which carries a free use license with few or no restrictions which would
  11. prevent its use. Current SNIPPETS material has been collected from the
  12. FidoNet C_Echo, comp.lang.c on the Internet, various public domain archives,
  13. and my own commercial library (MFL).
  14.  
  15.  
  16. How are SNIPPETS selected?
  17.  
  18. As the collection has evolved, it's taken on distinguishing characteristics
  19. based largely, I'm afraid, on what sorts of things interest me. A primary
  20. focus of SNIPPETS is portability - first of all between DOS compilers, and
  21. secondly with the larger world of Unix and other platforms. I tend to be
  22. interested in the same problem domain as Posix - system and utility
  23. functions. What I'm not interested in trying to include are things which
  24. really require massive amounts of code to do right (e.g.  GUIs, databases,
  25. interrupt-driven comm I/O, game-quality graphics, multimedia, etc.) and are
  26. therefore better addressed by large single-purpose packages, whether
  27. commercial or otherwise.
  28.  
  29. In addition to the utility stuff, I also snag anything that seems moderately
  30. obscure (e.g. ISBN validation, wind chill, sunrise/set time, etc.) Whether I
  31. need to know these things or not, someone sometime will need to be able to do
  32. these and I like to be able to provide the option of a simple canned solution
  33. rather than sending them on a research spree.
  34.  
  35.  
  36. What makes one SNIPPETS entry "better" than other candidates?
  37.  
  38. Anything that enhances portability or usability is better in my book. Note
  39. that I'm not necessarily soliciting completion to full library standards. As
  40. the name SNIPPETS implies, many of the entries knowingly have minimal
  41. bullet-proofing. Most of the entries I've excerpted from MFL differ only in
  42. that my commercial code provides bullet-proof error trapping at the cost of
  43. slightly obfuscating the algorithms. In cases where error trapping would, in
  44. my opinion, make the algorithm harder to follow, I've generally opted for
  45. clarity over safety. This was a conscious decision since the target audience
  46. for SNIPPETS includes both newbies and experienced programmers. The pros will
  47. recognize the shortcomings and know to add the error trapping, but the tyros
  48. can tend to get lost. My yardstick on this has been feedback. If too many
  49. tyros have to ask how it works, then I try to simplify and/or make the
  50. underlying algorithm stand out. If too many folks complain about it being
  51. unsafe, I add more bullet-proofing. When I hear as little from both sides as
  52. possible, I figure I've achieved the desired balance. 
  53.